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Light gun guide 


If you've ever been in a video game arcade before it's almost guaranteed you've seen a specially 
large cabinet featuring a fake “light” gun which could be used to aim at a screen displaying the game, 
one example being ® Terminator 2: Judgment Day. Thanks to the efforts of various developers and 
hardware manufacturers, it is now possible to bring that experience to the home using Batocera! This 
also includes the various home ports of such light gun games such as the infamous ® Duck Hunt. 


Once the light guns are connected, a crosshair will appear on the screen: 


The game list will also indicate which games are light gun compatible with a small theme-specific icon 
next to the name (this can be optionally disabled): 


ENTEATANMENT 
SYSTEM 


Super Mario Bros. + Duck Hunt 
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== Dragon's Lair ®© Æ 
K Dream Master Æ 


== DuckTales ®© Æ 
== DuckTales 2 © Æ 


You might come across few games that are not gun games with the light gun icon 
ey anyway in Batocera v35. These games have optional light gun support for an easter egg, 

specific scene, mini-game, etc. They are not configured automatically by the system. 

However, it is possible to manually configure them if you know what you are doing. 


Light gun comparison 


So first and foremost a light gun is needed, possibly multiple if intending on doing multiplayer (be 
careful of having enough physical space for both collision avoidance and tracking). Various light guns 
have entered the market and each offer their own advantages and disadvantages. If not specified, the 
light gun is compatible with all displays. Click the light gun to go to its section. 


Precision rating is based on five tests: 


. Calibration: is it triggering correctly and working as intended? 

Corner: is it aiming properly in extremities? 

. Position: is it accurate if you physically move from your stand position? 

. Rotation: is it accurate if you rotate the gun while aiming the same target? 

. Latency: is it triggering offscreen reload if quickly moving the aim outisde the display? 


ey All prices are subject to differ based on local availability and are only estimates; listed in 
USD. 


Minimum 
distance 


Light gun Tracking method Precision required Connectivity Bohai Notes 


AE Lightgun 
Requires at least nine 
feet/three metres of 
space to use. Has 
Infrared kde [3x to 3.5x/USB cable (290 cm) {$125 calibration issues, 
requiring multiple 
attempts before it will 
apply. 
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Light gun 


Tracking method 


Precision 


Minimum 
distance 
required 
(x* 
display 
size) 


Connectivity 


Estimated 
price 


Notes 


Ultimarc Aimtrak 


Infrared 


KK eve 


2x to 2.5x 


USB cable (370 cm) 


$95 (w/o 
recoil)/$120 (w/ 
recoil) 


Has calibration 
issues, requiring 
multiple attempts 
before it will apply. 


gun 


Mayflash Dolphinbar with Wiimote 


Infrared 


< 


kan eye 


1.5x 


Connect Dolphinbar to 
machine via USB 
cable, then Wiimotes 
to Dolphinbar via 
Bluetooth 


$10-20 second- 
hand Wiimote + 
$35 Dolphinbar 


Works universally 
across machines and 
Wiimotes, but tends 
to jitter. No 
calibration 
possible, crosshair 
is mandatory. This 
is the only option on 
v34 and lower. Also, 
the Wiimote itself is 
wireless (most other 
light guns are wired). 


Direct Wiimote gun with IR bar 


Infrared 


= 


KK eve 


2.5x 


Bluetooth 


$10-20 second- 
hand Wiimote + 
$3-$10 IR bar 


Need to have a 
powered IR sensor 
bar, but is far more 
accurate than using 
the Dolphinbar. Also, 
the Wiimote itself is 
wireless (most other 
light guns are wired). 
It is possible to 
convert the Mayflash 
Dolphinbar into a 
regular IR sensor bar 
with a firmware 
update, to use it as if 
though it were just a 
regular IR bar (this 
disables the 
Dolphinbar's 
Bluetooth connection, 
the Wiimote must be 
connected to a 
different device). 


Fusion Lightgun 
Lord 
FUSION MINI 
A OPEN SOURCE 
INFARED 
LIGHTGUN 


~w> ¢ 


Infrared 


kok ove 


2.5x 


USB cable 


$80 (DIY)/$200 
(pre-assembled) 


Larger displays 
require more physical 
distance (or wide/fish 
lens). Using SAMCO 
technology. 


GUN4IR 


Infrared 


meun. 


TOO I 


1.2x (with 
fisheye 
lens) to 
2x 
(without 
lens) 


USB cable 


$80 (DIY)/$200 
(pre-assembled) 


Larger displays 
require more physical 
distance (or wide/fish 
lens). Fully supported 
since v36. 


Namco GunCon2/G-Con2 


Cathode ray timing 


kkkkk 


0.2x to 1x 


Composite/component 
cable 


$25-$50 
second-hand, 
low availability 


Limited to analogue 
displays which 
supports 
composite/component 
input. This cannot 
be used on a 
modern digital 
display. 
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Minimum 
distance 
Light gun Tracking method Precision bees Connectivity soa Notes 
display 
size) 
GunCon3 
Larger displays 
require more physical 
Infrared kk or |1.5x to 2x|USB cable @ distance (or wide/fish 
lens). Fully supported 
since v38. 
Retro Shooter À , 
Recoil can optionally 
be disabled or put to 
tle 2.5x to 3x 185$ including single shot. Two IR 
Infrared Sede tee (2 IR) [USB cable a pedal and hub |requires massive 
2x (4 IR) for recoil distance or fish lens. 
(4 IR) A 
Fully supported since 
v39. 
SAMCO light gun 
tk ks 1.5x (USB cable ® D 
Sinden Ughtgun Recoil can optionally 
be disabled. Requires 
| $100 (wo ereen to display the 
White border on display tok kr 1.5x (USB cable (480 cm) recoil)/$160 (w/ white borders. Has 
recoil) a ya 
limitations on how 
many guns can be 
used per USB hub. 


Global calibration 


When a light gun is connected, a light gun symbol will appear in place of the controller activity icons 
(if that is enabled and the theme supports it). In addition, a new menu item will appear in the 
CONTROLLERS & BLUETOOTH SETTINGS menu specific to the light guns that are currently 
connected. This can be used to adjust settings specific to that light gun. 


Depending on the light gun, global calibration may be required. All global calibration can be 
performed at any time, even during gameplay, however this sort of calibration will always be for 
global calibration (it is not saved per-game, it's only needed to be done once). Refer to the section 
relevant to your light gun below for instructions. 
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Direct Wiimote gun with IR bar 


The Wii was revolutionary for its motion-based controls when it released back in 2006. This 
technology can now be used to emulate a light gun in Batocera, useful if you happen to have an old 
Wiimote and sensor bar laying around that is unused (though for convenience, buying a USB-powered 
sensor bar may be necessary). This is recommended over using the Mayflash Dolphinbar as the direct 
connection has far superior accuracy. 


This is a Special mode for the Wiimote when connected to Batocera. This will be referred to as the 
Wiimote gun from now on. Requires Batocera v35 or higher. 


v35 to v38: most third-party remotes won't work as they don't respect the correct 
© bluetooth connection process, requiring the Mayflash Dolphinbar Bluetooth module. 


v39+: enable the wiimote3rdparty option in SYSTEM SETTINGS > SERVICES to use 
your third-party wiimote. 


ey The Wiimote's face buttons have no function in Batocera v35, however this was fixed in 
Batocera v36. 


Direct Wiimote gun setup 


Set up the powered IR bar by taping over one side with solid tape and positioning the remaining LED 
at the bottom/top center of the display. Counter-intuitively, this setup works best when only one IR 
LED is visible (otherwise the cursor on-screen may “jump” when aiming at the edges). 
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Connect the Wiimote directly as a regular Bluetooth device. A notification will appear indicating that 
the Wiimote has connected in its gun mode, with a little light gun icon appearing (if the theme 
supports it). Once connected, press and hold the [Home] button for three seconds. A target will 
appear in the center of the screen, aim the Wiimote at it from your neutral shooting position and 
press [B]. Then a target will appear at the top-left; aim at that and press [B] again. 


If the second target cannot be shot at, move further away from the display and repeat the process 
from the start. It may also help to put the IR bar above the monitor instead of below. 


Dolphin can emulate the pairing function of the emulated Wii system, allowing for direct 
connections to the Wiimote. This is independent of what Wiimote gun settings are used 
in EmulationStation. 


Mayflash Dolphinbar 
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The Mayflash Dolphinbar is a third-party accessory that was initially designed to allow Wiimotes to be 
used as a cursor for PCs, or to allow for direct passthrough of the Wiimote to the Dolphin emulator 
(hence the colloquial name). Batocera can use it to emulate a light gun. 


Unlike the direct Wiimote connection method, modes 1 and 2 do not utilize any special Wiimote gun 
mode in EmulationStation to function, instead the Dolphinbar itself emulates being a mouse and 
keyboard to the machine. When in these modes, it does not allow for global calibration, meaning that 
it will not likely match your display one-to-one (just like the original Wii did). It is also the only 
available option for light gun play on v34 and lower. 


Certain third-party remotes that don't work over native Bluetooth may work with the Dolphinbar, as it 
uses its own Bluetooth stack separate from the host machine. 


Until recently, the Mayflash Dolphinbar could not be used as a regular IR sensor bar if 
intending to use the direct Wiimote connection method since the LEDs shut down after 
A some inactivity if no Wiimote is connected to it. A firmware update from Mayflash is 
required to unlock a new mode by pressing and holding [MODE] on the Dolphinbar (as 
shown in this short tutorial). The LEDs will remain powered on for 4 hours before shutting 
down. It is possible to directly connect a Wiimote to the bar to use it regularly though. 


Dolphin can emulate the pairing function of the emulated Wii system, allowing for direct 
connections to the Wiimote. This is independent of what Wiimote gun settings are used 
9 in EmulationStation. 


Mayflash Dolphinbar setup 


The Mayflash Dolphinbar requires manual action, compared to other solutions which automate most 
of the process. Because of this, it has its own page. 
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Namco GunCon 2 


The ® Namco GunCon (known as G-Con in Europe) is a PlayStation peripheral first released in 1994, 
with the GunCon 2 for the PlayStation 2 following it up in 2001. If you have a GunCon 2 anda 
compatible analogue TV, you may be able to utilise it with Batocera. This cannot be used on a 
modern digital display. Requires Batocera v36 or higher. 


Namco GunCon 2 setup 


Create a sh file inside the ports folder 


/userdata/roms/ports/GunCon2_Calibration.sh 


chmod +x /userdata/roms/ports/GunCon2_ Calibration.sh 


GunCon2_Calibration.sh 


#!/bin/bash 

xrandr --output $(xrandr | grep -o '.* connected' | sed 's/ 
connected//') --gamma 1:1:1 --brightness 2.0 
guncon2 _ calibrate.sh 

xrandr --output $(xrandr | grep -o '.* connected’ | sed 's/ 
connected//') --gamma 1:1:1 --brightness 1.0 


e The first line will increase the brightness via xrand 
e The second line will launch the calibration script via switchres 
e The third line will set the brightness back to default once the script exits. 


Calibration How To 


You only need to do a first calibration once. 
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e Start the calibration by pressing the gun trigger. 

e Follow the onscreen instructions and aim at all the 4 circles with the cross in the middle. 

e Try to be as exact as possible. 

e The result will not be perfect even if you aimed exactly in the middle using the GunCon2's 
crosshair. 

e This is normal.. 

e Exit the script and save the settings by pressing A or B 


Micro Calibrations in-game 


e Button C + D-pad left/right > decrease x-min > apply if your gun is out on left of the screen 
e Button C + D-pad up/down > increase x-max > apply if your gun is out on right of the screen 


Namco GunCon 3 


The ® Namco GunCon 3 (Known as G-Con 3 in Europe) is the last PlayStation peripheral of the series, 
released in 2007 in a bundle with Time Crisis 4. Instead of CRT, the light gun uses similar technology 
to Wiimote, with infrared LEDs placed left and right on top of the display. 


Requires Batocera v38 or higher. 
Namco GunCon 3 setup 


Place the infrared LEDs properly with enough distance between them, on top of your display, front 
facing the gun. Refer to 


official manual 
for best setup. 


V39: to start calibration, press and hold B2 button, then proceed to shoot each target. 


V40 or higher: to start calibration, press and hold C2 button. 


Ultimarc AimTrak 
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The Ultimarc Aimtrak comes with its own IR bar which can be mounted on the top of or at the bottom 
of the display, much like the Wiimote. Requires Batocera v35 or higher. 


Ultimarc AimTrak setup 


Connect both the light gun and the IR bar via USB. Then, hold main trigger for five seconds to launch 
the global calibration process. Shoot the top-left, top-right and bottom-center targets as they appear. 


The calibration information is saved to the gun itself, so a recalibration may be required if 
moving to a different display. 
Ultimarc AimTrak recoil 


If using a recoil model, a separate power supply is required. This is not bundled with the light gun. 
More info can be found on its store page. Scroll to Recoil Power Requirement (Guns with 
recoil option only) section. 


AE Lightgun 


The AE Lightgun comes with its own IR bar which can be mounted on the top of or at the bottom of 
the display, much like the Wiimote and Ultimarc AimTrak. Requires Batocera v35 or higher. 


AE Lightgun setup 
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Connect both the light gun and the IR bar via USB. Then, press the button in front of the main trigger 
to launch the global calibration process. Shoot the middle, top-right and bottom-left targets as they 
appear. 


Sinden Lightgun 


The Sinden Lightgun is a light gun which uses a regular camera looking at a white border to perform 
its tracking. Batocera will automatically enable a white border when the Sinden Lightgun is 
connected, as well as shrinking the content of the games to accomodate for this. Requires Batocera 
v35 or higher. 


A hardware bug prevents the use of multiple Sinden Lightguns on a single USB hub on 
“A some boards. Computers will typically use a single hub for groups of the same ports 
KS accessed via the IO panel. The best way around this is to plug one light gun into the front 
facing ports, and another into the IO panel. If your machine has a mixture of USB 2.0 
(black tongue) and USB 3.0 (blue tongue) ports, they will usually have separate hubs. 


Sinden Lightgun setup 


Connect the USB cable to the machine. Then hold left on its D-pad for five seconds. Shoot the center 
of the screen. Calibration is complete. 


Sinden Lightgun settings 


Sinden Lightguns offer the following options in CONTROLLER & BLUETOOTH SETTINGS > SINDEN 
GUN SETTINGS 


e BORDER SIZE: Thin, medium or big. By default, the medium one is enabled (the size may differ 
depending on the emulator). 
¢ BORDER MODE: Select when to display the border. 
o NORMAL: Always shown in EmulationStation and in game (default) 
o IN GAME ONLY: Only shown when playing a light gun game. 
o HIDDEN: Disable, useful if using your own bezels with their drawn border. 
e BORDER COLOR: Change the color of the border either in white (default), red, green or blue. 
e CAMERA CONTRAST: Adapt the camera contrast to your setup (daytime/bright, default, dim 
display/evening) 
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e CAMERA BRIGHTNESS: Adapt the camera brightness to your setup (daytime/bright, default, 
dim display/evening) 
e CAMERA EXPOSURE: Adjust the camera exposure to your setup (useful for projector/crt) 
e RECOIL: Adjust the behaviour and strength of the force-feedback when holding down the 
trigger. 
o No recoil: No force-feedback at all. 
o Gun: Recoil, delay, then rapid recoil until trigger is released. 
o Quiet gun: Same as “Gun”, but less intensity. 
o Machine gun: Rapid recoil until the trigger is released. 
o Quiet machine gun: Same as “Gun machine”, but less intensity. 


CONTROLLER & BLUETOOTH SETTINGS 


CONTROLLER & BLUETOOTH SETTINGS 


RECOIL QUIET GUN 


GUN4GIR 
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GUNGIR setup 


For the time being, any custom and manual settings must be done inside Windows with GUN4IR tool 
and burned into the light gun. 


If you have the calibration button, press it and shoot all targets in turn. 


Retro Shooter Lightgun 


The Retro Shooter comes with its own IR leds (two on older models; four since october 2023). They 
are mounted at top corners (2IR) or all four corners (4IR) of the display, similar to SAMCO and Fusion 
Lightgun. 


Requires Batocera v39 or higher. 


Retro Shooter setup 


Place IR leds as shown below : 


To calibrate the light gun, press and hold 3 seconds the rear left button, then proceed on shooting 
target. Make sure you are far enough from your display and sunlight is out. If you are with 2IR leds, 
you need to double that distance. 
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The light gun will reboot with updated values once calibration is done. 


Retro Shooter recoil 


e To switch between single shot or automatic, press and hold stick button 3 seconds to change its 
mode. 
e To turn off the recoil, unplug the recoil cable or press and hold stick button while powering it. 


Emulator support 


A table showing which emulators and cores support light guns (must be switched manually for 
systems using a default core not compatible with light guns). 


Initial gun 
[ron me a frm eee e 
Multiplayer 
retroarch/opera unsupported for 
now 
Supported but not 


a cc ee ee ed a 
~~ retroarchymame2003. 35 CS 
retroarchymame2010.) e S S 
rretroarchyfoneo E a 
atarieoo mame e S o 
atari2600  vetroarchstela =| 


multiplayer 


Pye ASt unsupported for 


Multiplayer 
unsupported for 


masta a a E O T B D T 
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Initial gun 
CeO 
model2 model2emu unsupported for 
——— 


model Supermodel | 5 7 


— > i 
naomi flycast unsupported for 
EE 


— etroarch/flycast | 35 | 4 | 


ne 2x6 
namco2x6 Play! emulation is very 
early 


nes fretroarchmestopa | 3 O 7 o ‘(ST 
ereen s 07 o S 
Oo feroaren | s a l 


Multiplayer 
duckstation unsupported for 

now 

Only works with 


E E | _*_ 

n O o a O S a 
O AO E a 
e a a 


PS Move — 


rah e | 35 
E a 
segacd__fetroarchipicodrive | x OOOO o S 
n oO O as [7 
e a 


—— r r 
TEET E E E S O E F 
steam tem s o a 
e E A A 
windows(wine)wineutrs | Umtestea | | e 
E <_< $= E 
C a E S S 
axspectrum lretroarchifuse | x OOOO S o 


Games which are light gun compatible will belong to the light gun genre in EmulationStation. Some 
themes support showing this tag to make it easier to quickly identify which games are light gun 
games. It is also possible to enable the light gun category as a selectable system. 
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Button mapping (WIP) 


Emulators buttons mapping 


Each light gun has its own button code when pressed. This code is translated to a global code in 
Batocera. When triggered, the global code will be translated into the emulator to a specific command. 
In the future, it will be possible to customize the mapping. 


For example: when pressing the physical MINUS button on the Wiimote, it triggers the button event 
KEY PREVIOUS, which is translated to the global code event BTN_1 in Batocera, which activates the 
Coins value in Naomi and MAME arcade games. 


Name cioba Ir-snes9x|Ir-genesisplusgx|Ir-beetle-saturn Ir-pcsx_rearmed| Ir-fbneo Ir-flycast PCSX2 | RPCS3 MAME [Dolphin/Wiiļmodel2emu Supermodel 
Trigger| BTN_LEFT | FIRE TRIGGER TRIGGER TRIGGER TRIGGER | TRIGGER | Trigger T TRIGGER B TRIGGER | TRIGGER 
Action| BTN_RIGHT | CURSOR 1 RELOAD A/SPECIAL _|SECONDARY|SECONDARY/B| C MOVE (~)|SECONDARY A RELOAD RELOAD 
Start |BTN_MIDDLE] TURBO 2 START B/START START START A START | START PLUS COIN COIN 
Select| BTN_1 PAUSE PAUSE COIN COIN B D COIN MINUS START |EVENT/START 
SUB1 BTN 2 ee ae 1 

SUB2 | BTN 3 Start 2 

SUB3 | BTN_4 Select HOME 

Up BTN_5 D-Pad Up D-Pad Up Lae as D-Pad/Up 

Down| BTN_6 D-Pad Down ce ee D-Pad/Down 

Left | BTN_7 D-Pad Left | D-Pad Left | SELECT D-Pad/Left 

Right | BTN_8 D-Pad Right ren D-Pad/Right 
Default global mapping 

Global : ‘ Fl Fusion Retro | Sinden as 
Name code AElightgun|AimTrack|Dolphinbar Lightgun GUN4IR_ |GunCon2|GunCon3 Shooter] Lightgun Wiimote 
Trigger| BTN_LEFT Trigger Trigger B Trigger Trigger Trigger | Trigger | Trigger | Trigger B 
Action | BTN_RIGHT | Front left /Rightside) A Bomb, lofiscreen/A/C| € A | Right |Pump/Front) 4 
= Reload side left 
Start |BTN_MIDDLE| Middle left | Left side Start B A B2 i Rear left | PLUS 
Select BTN_1 Rear left #1 Select START B B1 Rear left| Rear right | MINUS 
SUB1 BTN_2 (Rear left #2 A SELECT SELECT A2 ia Front right 1 
SUB2 BIN 3 Rear left #3 B START Cl 2 
SUB3 BIN 4 Rear left #3 C2 HOME 
BTN_5 | Top back a E E i 
Down| Brue | Bottom 4 n n n n 
z back 

Left BTN_7 e e e e e 
Right BIN 8 > > > > > > > 


Per-game testing spreadsheet 
A list of tested light gun games (and any notes that pertain to them specifically) can be found on its 
own spreadsheet. 


Beta testing, bug-finding and workarounds are welcomed on the Discord channel #Lightguns or on 
the mega-issue report. 
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Per-emulator notes 


Although most light gun games will be plug and play, certain titles/emulators require extra actions 
(typically calibration in the emulated game itself). These are limitations of the software, but will be 
automated in the future for games that require it. 


3DO (Ir-opera) 


In-game recalibration is required, located in the game menu options. This is different per-game. This 
only needs to be done once. 


Arcade (general) 


MAME 


A few games have an offscreen reload system which does not work well with the 
Wiimote. The system can be forced to perform a manual reload action with a press of the 
primary button (in the Wiimote's case, [A]): 


1. While in the MAME gamelist, press [SELECT]. Then go to ADVANCED SYSTEM 
SETTINGS. 
2. Go to OFF-SCREEN RELOAD and set it to “ON”. 


Hopefully, this issue will be fixed in future versions such that offscreen reloading works 
out of the box with the Wiimote. 


The current accuracy is not perfectly 1:1, caused by a fake and forced 4:3 ratio. This will be fixed in 
the future. 


Redream 


Configure the emulator first (controller to Lightgun, map missing buttons) 
how? step-by-step) 


Commodore 64 


Commodore 64 games were released in various mediums. It was very common for all tape ROMs (TAP 
files) light gun games to also feature a joystick version on the other side of the tape. In order to use 
light guns, the light gun version of the game is needed. Disk images usually support both. 
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Model 2 (model2emu) 


If updating Batocera from a version previous to v38, it is mandatory to delete your 
ey /userdata/saves/model2 folder. Model2emu package was rehauled and can't 

overwrite what's already existing. You might need to save any custom input located in 

/userdata/saves/model2/model2emu/CFG/. 


By default, the crosshair is on in Batocera from v35 to v37. This crosshair does not follow where the 
light gun is actually pointing. 


To disable it, open /SHARE/saves/model2/model2emu/EMULATOR. ini and search for the line 
DrawCross = 1. Change the value to 0 and save the file. 


In Batocera v35 to v37, default bezels are broken for the Sinden Lightgun for this 
emulator. This can be worked around: 


1. If it is not done yet, run for the first time a model2 rom to download the required 
files. 
Y 2. Download the Model 2 Sinden Bezel Pack. 
3. Open the archive file and extract artwork and scripts folders from either 720p 
or 1080p into /userdata/saves/model2/model2emu. Overwrite existing files if 


prompted to do so. 
4. Play! 


This is fixed in Batocera since v38. 


Model 3 (Supermodel) 


Supermodel white border for Sinden Lightguns is currently disabled on rpi4 and rpi5. This will be 
added in the future. 


PSX (all) 


Starting v39, all gun games are compatible with both Justifier and GunCon light gun controller type in 
PCSX-reARMed core. If a GunCon conversion patch was applied to the ROM, you will need to force 
GunCon controller type in EmulationStation. 


In v35 to v38 however, all PSX emulators are only compatible with GunCon ROMs (with exception to 
libretro: mednafen, which should be compatible with all ROMs but a bug prevents the use of any light 
guns), so any non-GunCon ROMs require the Nuvee patch in order to function with light guns in the 
emulators: 
https://forums.pcsx2.net/Thread-Nuvee-PS1-PS2-input-plugin-supporting-lightguns-by-Shalma. 
Instructions are in the .7z file, respectively for each patchable ROM. 
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Otherwise, light gun games with justifiers are playable with Libretro: mednafen psx core, but 
need to have the following settings adjusted: 


. Open RetroArch quick menu with [HOTKEY] + 

. Select Core Options 

. Change Renderer (Restart Required) to “Software” 

. Go back and select Controls option 

. In Port # controls change the Device Type to “Justifier” 
. Restart the game in the RetroArch quick menu 


Au BRWNF 


Saturn (only libretro: beetle-saturn) 


In-game recalibration is required, located in the game menu options. This is different per-game. This 
only needs to be done once. 


SNES 


The Justifier controller type does not work in libretro: mesen-s and libretro: bsnes, rendering Lethal 
Enforcers unplayable with these cores. 


A note about the controller type option 


Veteran users may recall the controller type option in the advanced system settings for each system 
needing to be set to a particular light gun (specific to that system) in order to play light gun games. 
As of v35, this is no longer necessary, as Batocera will automatically use the appropriate controller 
type if a light gun is connected. The crosshair option will also be automatically disabled for 
the light guns - except if you play with the Mayflash Dolphinbar, which will be automatically 
enabled. 


Two new options have been added to the global game options: 


e USE GUNS: The magic that enables all of this to be configured automatically. 
¢ SHOW LIGHTGUN CROSSHAIRS: Opt to manually show the crosshairs (perhaps to assist with 
aiming in general), manually remove the crosshairs or let Batocera decide for you. 
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NINTENDO ENTERTAINMENT SYSTEM 


USE GUNS 


Troubleshooting 


Wiimote issues 
I can't aim at the upper-left target! I've moved as far back as I can 


The Wiimote works by sending a video feed of its IR camera to the machine. This sensor is very poor, 
and can fail to see the IR LED if too far away. So, there's a “sweet spot” for each display where you 
are both far enough away to see the IR bar when aiming at the extreme corner opposite the IR bar, 
while still being close enough for the IR camera of the Wiimote to pick it up. 

To debug this to get an accurate reading, connect via SSH and run the following: 


Xwiishow 1 


This will show a video feed of the IR camera in the upper-right of the SSH session: 
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To visualize what this information represents, imagine this being a flipped version of the position 
being aimed at on the display: 


But I'm not using a Wiimote! 


Make sure there are no reflective surfaces or other obstructions that can interfere with the visual. If 
placing the LED on a flat surface like the top of the entertainment unit, ensure it is as close to the 
edge as possible to make sure it's not obscured by its edge when aiming from a lower position (you 
may want to prop up the IR bar on some rubber stoppers). 


My Wiimote is appearing as a regular controller instead of a light gun 


First, ensure you are running Batocera v35 or higher. 
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Otherwise, ensure that CONTROLLER & BLUETOOTH SETTINGS > WIIMOTE GUN SETTINGS > 
MODE and set it to “GUN”. 


CONTROLLER & BLUETOOTH SETTINGS 


CONTROLLER & BLUETOOTH SETTINGS 
SU 4 GUN D 


My recoil isn't working 
Replug the light gun or change recoil settings. 


My second Sinden crosshair is stuck upper-left corner 


į} Batocera is not compatible with beta firmware. If your gun is 
wy on v1.9 or later, please downgrade to v1.8. 


Avoid using a USB hub when connecting both guns. Use different USB speed port for each (ex.: USB 
2.0/USB 3.0) or different pair (ex.: one in front of the PC, one in the back). If using a Raspberry Pi, 
make sure you have enough power voltage. 
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A reboot might be necessary if hot plugged in. 


X Fix Me! RPi4: Plug your first sinden in USB3 port. Wait 10s. Plug your second sinden in 


USB2 port. Wait 10s. 
You need a good amount of power voltage too. 


Steam Deck dock: Most issues are fixed with a good quality SDCard and the official Steam Deck 
dock with good amount of power voltage. 


Later Sinden Lightgun models There actually is a known issue with later models cameras. If you 
bought in mid-2023 and later, you might encounter this issue even if it works fine on Windows. 


Open the file manager (F1) or connect with SSH and navigate to /var/log/ folder. There, you should 
see virtual-sindenlightgun* file logs. Open it and if you see this : 


Copyright Sinden Technology 2020. 
Version 1.8 


Only for use with offical Sinden Lightguns. 


Starting..... 
CameraName: USB2.0 HD UVC W 
Recoil Off eos 


CalibrationX from gun: -2.04 

CalibrationY from gun: -4.69 

Lightgun Firmware: v1.8 Tai 
Could not find Sinden Lightgun Camera Device. 
Camera ID maybe incorrectly set, please see Ci 
Please connect Sinden Lightgun. £765 


Or this: 


ght Sinden Technology 2020. 
ion 1.8 
y for use with offical Sinden Lightguns. 


ld not find Sinden Lightgun Camera Device. 
ra ID maybe incorrectly set, please see Ca 
ase connect Sinden Lightgun. E765 


You might need to update your camera name by following the the guide here (.PDF). 
My aiming accuracy in certain games is much worse than others 


Some games offer a recalibration menu in-game. Use that to work around such issues. This will be 
different per-game of course. 
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Arcade games typically require the use of the service menu, refer to the exceptions section above. 


I'm having another issue 


Check out the mega-issue report, it's probably already been reported. 


If having issues with ROM loading itself, check out the generic troubleshooting page. 


1) 


2P only with Gangster Town 


2) 


2P only with Lethal Enforcers 
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